home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / 4sq21.zip / 4SQUARE.DOC < prev    next >
Text File  |  1993-06-22  |  14KB  |  293 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 4  S Q U A R E
  7.                                 --------------
  8.                                      v2.1
  9.  
  10.         One of the MicroNet Collection of multi-BBS Doorware programs.
  11.             Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire
  12.           UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
  13.  
  14.                                       By
  15.  
  16.                                   Ted Freeman
  17.                                 Rt. 1, Box 869
  18.                               Tazewell, TN 37879
  19.  
  20.                            (c) Copyright 1991 - 1993
  21.                               All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                CONTENTS
  30.                                ========
  31.                                                                              
  32.       Information:      ~Copyright~
  33.                            ~Warranty~
  34.                               ~Distribution~
  35.                                  ~Registration~
  36.                                                                              
  37.       Door Operation:   ~Configuration Files~
  38.                            ~Environment Variables~
  39.                               ~Batch File~
  40.                                  ~Top Ten Bulletin~
  41.                                     ~Sysop Keys~
  42.                                        ~Fossil Drivers~
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                          ^Configuration Files^
  49.                           -------------------
  50.                                                                              
  51.                                                                              
  52.    Use the left/right arrows keys to select the desired system file
  53.    then press ENTER.
  54.  
  55.  
  56.  
  57.                 ~CALLINFO.BBS~
  58.                    ~CHAIN.TXT~
  59.                       ~DOOR.SYS~
  60.                          ~DORINFOx.DEF~
  61.                             ~GTUSER.BBS~
  62.                                ~PCBOARD.SYS~
  63.                                   ~SFDOORS.DAT~
  64.                                     ~TRIBBS.SYS~
  65.                                         ~USERS.SYS~
  66.                                            ~USERINFO.DAT~
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73. #
  74.  
  75. Example configuration file for|PCBOARD.SYS|
  76. ------------------------------------------
  77.                                                                              .
  78. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  79. MicroNet            <=-  (Change this to your BBS name)
  80. Ted                 <=-  (The Sysop's first name)
  81. Freeman             <=-  (The Sysop's last name)
  82.  
  83. Example configuration file for|USERS.SYS|
  84. ------------------------------------------
  85.                                                                              .
  86. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  87. MicroNet            <=-  (Change this to your BBS name)
  88. Ted                 <=-  (The Sysop's first name)
  89. Freeman             <=-  (The Sysop's last name)
  90.  
  91. Example configuration file for|DOOR.SYS|
  92. ---------------------------------------
  93.                                                                              .
  94. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  95. MicroNet PCBoard    <=-  (Change this to your BBS name)
  96. Ted                 <=-  (The Sysop's first name)
  97. Freeman             <=-  (The Sysop's last name)
  98.  
  99. Example configuration file for|USERINFO.DAT|
  100. -------------------------------------------
  101.                                                                              .
  102. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  103. MicroNet PCBoard    <=-  (Change this to your BBS name)
  104. Ted                 <=-  (The Sysop's first name)
  105. Freeman             <=-  (The Sysop's last name)
  106. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  107.  
  108. Example configuration file for|CALLINFO.BBS|
  109. -------------------------------------------
  110.                                                                              .
  111. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  112. MicroNet            <=-  (Change this to your BBS name)
  113. Ted                 <=-  (The Sysop's first name)
  114. Freeman             <=-  (The Sysop's last name)
  115.  
  116. Example configuration file for|DORINFOx.DEF|
  117. -------------------------------------------
  118.                                                                              .
  119. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  120.                           where 'x' is the BBS Node number.
  121. MicroNet            <=-  (Change this to your BBS name)
  122. Ted                 <=-  (The Sysop's first name)
  123. Freeman             <=-  (The Sysop's last name)
  124.  
  125. Example configuration file for|SFDOORS.DAT|
  126. ------------------------------------------
  127.                                                                              .
  128. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  129. MicroNet            <=-  (Change this to your BBS name)
  130. Ted                 <=-  (The Sysop's first name)
  131. Freeman             <=-  (The Sysop's last name)
  132.  
  133. Example configuration file for|CHAIN.TXT|
  134. ----------------------------------------
  135.                                                                              .
  136. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  137. MicroNet            <=-  (Change this to your BBS name)
  138. Ted                 <=-  (The Sysop's first name)
  139. Freeman             <=-  (The Sysop's last name)
  140.  
  141. Example configuration file for|GTUSER.BBS|
  142. ----------------------------------------
  143.                                                                              .
  144. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  145. MicroNet            <=-  (Change this to your BBS name)
  146. Ted                 <=-  (The Sysop's first name)
  147. Freeman             <=-  (The Sysop's last name)
  148. 1                   <=-  (COM port number - defaults to 1)
  149. 1                   <=-  (Node number - defaults to 1)
  150.  
  151. Example configuration file for|TRIBBS.SYS|
  152. ----------------------------------------
  153.                                                                              .
  154. C:\BBS\TRIBBS.BBS   <=-  (Full pathname of your TRIBBS.SYS file)
  155. MicroNet            <=-  (Change this to your BBS name)
  156. Ted                 <=-  (The Sysop's first name)
  157. Freeman             <=-  (The Sysop's last name)
  158.  
  159. Example|Batch File|
  160. -------------------
  161. A sample batch file is included and is similar to the following:
  162.                                                                              .
  163.    ECHO OFF
  164.    CD\DOORS\4SQUARE        <=- Switch to the door's Directory.
  165.    4SQUARE 4SQUARE.CNF     <=- Execute the door program and pass the
  166.                                 configuration filename to the program.
  167.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  168.    BOARD                   <=- Restart BBS.
  169.                                                                              .
  170. This Door is multi-node  compatible so you may run more than 1 node from
  171. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  172. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  173. variables, (q.v.)
  174.  
  175.                             |Environment Variables|
  176. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  177. variables. Non-PCBoard systems may also use these variables by including
  178. the following in either your BBS batch or AUTOEXEC.BAT
  179.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  180.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  181. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  182. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  183. .CNF file for multi-node operation!
  184.                                                                              .
  185. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  186. command line.  For example:
  187.                                                                              .
  188.      4SQUARE 4SQUARE.CNF /5
  189. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  190.      4SQUARE 4SQUARE.CNF /%IRQ%  
  191.                                                                              .
  192. This tells the program to use IRQ 5 instead of the standard IRQ.
  193.  
  194.  
  195.                           |Top Ten Bulletin|
  196.                            ----------------
  197.                                                                              .
  198. The first time you run  4 SQUARE  online it  will create 3  files called
  199. 4SQUARE.BUL,  4SQUARE.BLT and  4SQUAREG.BLT.  If you wish to  change the
  200. path or filename of the Bulletin you must edit  4SQUARE.BUL & change the
  201. first line to whatever path/filename you desire.
  202.  
  203.  
  204.                              |Sysop Keys|
  205.                               ----------
  206. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  207.          written to DOOR.SYS and USERS.SYS
  208. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  209.          and/or written to DOOR.SYS and USERS.SYS
  210. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  211. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  212.          and/or written to DOOR.SYS and USERS.SYS
  213. F8    -  Returns the caller involuntarily to the BBS.
  214. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  215.          and/or written to DOOR.SYS and USERS.SYS
  216. F10   -  Activates SysOp CHAT mode within the DOOR.
  217. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  218. UP    -  Give the caller extra time while in the DOOR.  
  219. DN    -  Subtract time from the caller while in the DOOR. 
  220. HOME  -  HELP key for Status Line options.
  221. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  222. ALT-X -  PCBoard will exit after current caller logs off. Value is
  223.          passed to PCBoard. Not available on non-PCBoard systems.
  224.  
  225.                             |Distribution|
  226.                              ------------
  227.                                                                              .
  228. This program is being distributed via the SHAREWARE concept and as such,
  229. may be copied freely with the following restrictions:
  230.                                                                              .
  231.         * The program must be supplied in it's original unmodified
  232.           form, including documentation.
  233.                                                                              .
  234.         * This program may not be distributed as part of any commercial
  235.           application or service without the express, written consent
  236.           of the author.
  237.                                                                              .
  238.         * Vendors of Shareware/Public Domain software may not
  239.           distribute this program without the express, written
  240.           consent of the author, unless Vendor has been approved
  241.           by the Association of Shareware Professionals (ASP).
  242.  
  243.  
  244.                             |Registration|
  245.                              ------------
  246.                                                                              .
  247. This door represents  many hours of  programming and the author deserves
  248. just compensation for his time, efforts and expertise.  If you find this
  249. program to be of some  value and you  continue to use it on your system,
  250. you must return the order form provided along with the registration fee.
  251. Registration  entitles you to  free upgrades via  modem from  MicroNet's
  252. Support Conference.  Payments should be  made in the  form of a check or
  253. money order. Foreign orders  must be in U.S. funds drawn on a U.S. bank. 
  254.     Online registration with Visa or Mastercard is available via our
  255.     Credit Card Door on the following systems:
  256.                                                                              .
  257.       MicroNet: (615) 626-1620 USR DS  Livewire: (609) 235-5297 MNP5
  258.         (TN)                             (NJ)    (609) 866-2551 HST DS
  259.                                                  (609) 727-3246 MNP5
  260.                                                                              .
  261. NOTE: If you register online, your registration number will be posted in
  262.       a private  message on  the system  you registered  with.  When you
  263.       register by mail, your number will be posted on MicroNet.
  264.  
  265.                               |Copyright|
  266.                                ---------
  267.                                                                              .
  268. 4 Square,  Copyright (c)1990-93 by Ted Freeman, is being  distributed as
  269. Shareware.  Under this concept you may use the  SHAREWARE (unregistered)
  270. version for a reasonable period of  time for evaluation  after which you
  271. must either register your copy or discontinue  usage.
  272.  
  273.                               |Warranty|
  274.                                --------
  275.                                                                              .
  276. This product is provided as is without warranty of any kind.  The entire
  277. risk as to the results and performance of the program is assumed by you.
  278. Futhermore, the  author does not warrant, guarantee, or  make any  other
  279. representations regarding the use of,  or the  results of the use of the
  280. program,  and you rely on the  program and  results  solely at  your own
  281. risk.  The author  cannot and will not accept  responsibility for system
  282. damage, loss of profit or any other special, consequential or incidental 
  283. damages  resulting  from  the use of or inability to  use this  product.
  284.  
  285.                             |Fossil Drivers|
  286.                              --------------
  287.                                                                              .
  288. This door may be used with Fossil drivers such as X00 & BNU.  This makes
  289. it compatible  with most  multi-port  boards.  To use the Fossil  driver
  290. instead of the standard COM ports, include  /FD on the command line when
  291. running the door. For example: 4SQUARE 4SQUARE.CNF /FD
  292.  
  293.